colorOverlay

Type

property

Summary

Specifies the color overlay to use for an object.

Syntax

set the colorOverlay of object to <propertiesArray>

set the colorOverlay[<propertyName>] of object to <propertyValue>

Description

Use the colorOverlay property to overlay a flat color on an object. The colorOverlay is an array style property, each key of the array controls a different colorOverlay parameter that will affect its final appearance. The easiest way to adjust these properties is by using the Graphic Effects card of the property inspector which has full control over each parameter. To control the effect by script use the following properties:

• colorOverlay["color"] : The color of the overlay, in the format red,green,blue where each value is between 0 and 255.

• colorOverlay["blendMode"] : How the overlay is blended with the object. This is one of the following values:

  • "normal" : the glow is laid directly over the object.
  • "multiply" : this results in a darkening effect
  • "colorDodge" : this results in a lightening effect

colorOverlay["opacity"] : How opaque the overlay is. The value is between 0 (fully transparent) and 255 (fully opaque).

Examples

set the colorOverlay of button "Ok" to tOverlayPropertiesArray

set the colorOverlay["color"] of me to "255,0,0"

Related

property: innerShadow, innerGlow, dropShadow, outerGlow, blendLevel, ink

Compatibility and Support

Introduced

LiveCode 4.0.0

OS

mac

windows

linux

ios

android

Platforms

desktop

mobile